home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / ifl / TIFFWriteScanline.z / TIFFWriteScanline
Text File  |  1998-10-20  |  9KB  |  133 lines
  1.  
  2.  
  3.  
  4. TTTTIIIIFFFFFFFFWWWWrrrriiiitttteeeeSSSSccccaaaannnnlllliiiinnnneeee((((3333TTTT))))                IIIImmmmaaaaggggeeee FFFFoooorrrrmmmmaaaatttt LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      TIFFWriteScanline - write a scanline to an open TIFF file
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ttttiiiiffffffffiiiioooo....hhhh>>>>
  13.      iiiinnnntttt TTTTIIIIFFFFFFFFWWWWrrrriiiitttteeeeSSSSccccaaaannnnlllliiiinnnneeee((((TTTTIIIIFFFFFFFF**** ttttiiiiffff,,,, ttttddddaaaattttaaaa____tttt bbbbuuuuffff,,,, uuuuiiiinnnntttt33332222 rrrroooowwww,,,, ttttssssaaaammmmpppplllleeee____tttt
  14.      ssssaaaammmmpppplllleeee))))
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      Write data to a file at the specified row.  The _s_a_m_p_l_e parameter is used
  18.      only if data are organized in separate planes (_P_l_a_n_a_r_C_o_n_f_i_g_u_r_a_t_i_o_n=2).
  19.      The data are assumed to be uncompressed and in the native bit- and byte-
  20.      order of the host machine.  The data written to the file is compressed
  21.      according to the compression scheme of the current TIFF directory (see
  22.      further below).  If the current scanline is past the end of the current
  23.      subfile, the _I_m_a_g_e_L_e_n_g_t_h field is automatically increased to include the
  24.      scanline (except for _P_l_a_n_a_r_C_o_n_f_i_g_u_r_a_t_i_o_n=2, where the _I_m_a_g_e_L_e_n_g_t_h cannot
  25.      be changed once the first data are written).  If the _I_m_a_g_e_L_e_n_g_t_h is
  26.      increased, the _S_t_r_i_p_O_f_f_s_e_t_s and _S_t_r_i_p_B_y_t_e_C_o_u_n_t_s fields are similarly
  27.      enlarged to reflect data written past the previous end of image.
  28.  
  29. NNNNOOOOTTTTEEEESSSS
  30.      The library writes encoded data using the native machine byte order.
  31.      Correctly implemented TIFF readers are expected to do any necessary
  32.      byte-swapping to correctly process image data with BitsPerSample greater
  33.      than 8.  The library attempts to hide bit-ordering differences between
  34.      the image and the native machine by converting data from the native
  35.      machine order.
  36.  
  37.      In C++ the _s_a_m_p_l_e parameter defaults to 0.
  38.  
  39.      Once data are written to a file for the current directory, the values of
  40.      certain tags may not be altered; see _T_I_F_F_S_e_t_F_i_e_l_d(3T) for more
  41.      information.
  42.  
  43.      It is not possible to write scanlines to a file that uses a tiled
  44.      organization.  The routine _T_I_F_F_I_s_T_i_l_e_d can be used to determine if the
  45.      file is organized as tiles or strips.
  46.  
  47. RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEESSSS
  48.      _T_I_F_F_W_r_i_t_e_S_c_a_n_l_i_n_e returns -1 if it immediately detects an error and 1 for
  49.      a successful write.
  50.  
  51. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  52.      All error messages are directed to the _T_I_F_F_E_r_r_o_r(3T) routine.
  53.  
  54.      %%%%ssss:::: FFFFiiiilllleeee nnnnooootttt ooooppppeeeennnn ffffoooorrrr wwwwrrrriiiittttiiiinnnngggg ....  The file was opened for reading, not
  55.      writing.
  56.  
  57.      CCCCaaaannnn nnnnooootttt wwwwrrrriiiitttteeee ssssccccaaaannnnlllliiiinnnneeeessss ttttoooo aaaa ttttiiiilllleeeedddd iiiimmmmaaaaggggeeee.  An attempt was made to write a
  58.      scanline to a tiled image.  The image is assumed to be organized in tiles
  59.      because the _T_i_l_e_W_i_d_t_h and _T_i_l_e_L_e_n_g_t_h tags have been set with
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. TTTTIIIIFFFFFFFFWWWWrrrriiiitttteeeeSSSSccccaaaannnnlllliiiinnnneeee((((3333TTTT))))                IIIImmmmaaaaggggeeee FFFFoooorrrrmmmmaaaatttt LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll
  71.  
  72.  
  73.  
  74.      _T_I_F_F_S_e_t_F_i_e_l_d(3T).
  75.  
  76.      CCCCoooommmmpppprrrreeeessssssssiiiioooonnnn aaaallllggggoooorrrriiiitttthhhhmmmm ddddooooeeeessss nnnnooootttt ssssuuuuppppppppoooorrrrtttt rrrraaaannnnddddoooommmm aaaacccccccceeeessssssss.  Data was written
  77.      in a non-sequential order to a file that uses a compression algorithm and
  78.      that has _R_o_w_s_P_e_r_S_t_r_i_p greater than one.  That is, data in the image is to
  79.      be stored in a compressed form, and with multiple rows packed into a
  80.      strip.  In this case, the library does not support random access to the
  81.      data.  The data should either be written as entire strips, sequentially
  82.      by rows, or the value of _R_o_w_s_P_e_r_S_t_r_i_p should be set to one.
  83.  
  84.      %%%%ssss:::: MMMMuuuusssstttt sssseeeetttt """"IIIImmmmaaaaggggeeeeWWWWiiiiddddtttthhhh"""" bbbbeeeeffffoooorrrreeee wwwwrrrriiiittttiiiinnnngggg ddddaaaattttaaaa.  The image's width has not
  85.      be set before the first write.  See _T_I_F_F_S_e_t_F_i_e_l_d(3T) for information on
  86.      how to do this.
  87.  
  88.      %%%%ssss:::: MMMMuuuusssstttt sssseeeetttt """"PPPPllllaaaannnnaaaarrrrCCCCoooonnnnffffiiiigggguuuurrrraaaattttiiiioooonnnn"""" bbbbeeeeffffoooorrrreeee wwwwrrrriiiittttiiiinnnngggg ddddaaaattttaaaa.  The organization
  89.      of data has not be defined before the first write.  See _T_I_F_F_S_e_t_F_i_e_l_d(3T)
  90.      for information on how to do this.
  91.  
  92.      CCCCaaaannnn nnnnooootttt cccchhhhaaaannnnggggeeee """"IIIImmmmaaaaggggeeeeLLLLeeeennnnggggtttthhhh"""" wwwwhhhheeeennnn uuuussssiiiinnnngggg sssseeeeppppaaaarrrraaaatttteeee ppppllllaaaannnneeeessss.  Separate image
  93.      planes are being used (_P_l_a_n_a_r_C_o_n_f_i_g_u_r_a_t_i_o_n=2), but the number of rows has
  94.      not been specified before the first write.  The library supports the
  95.      dynamic growth of an image only when data are organized in a contiguous
  96.      manner (_P_l_a_n_a_r_C_o_n_f_i_g_u_r_a_t_i_o_n=1).
  97.  
  98.      %%%%dddd:::: SSSSaaaammmmpppplllleeee oooouuuutttt ooooffff rrrraaaannnnggggeeee,,,, mmmmaaaaxxxx %%%%dddd.  The _s_a_m_p_l_e parameter was greater than
  99.      the value of the SamplesPerPixel tag.
  100.  
  101.      %%%%ssss:::: NNNNoooo ssssppppaaaacccceeee ffffoooorrrr ssssttttrrrriiiipppp aaaarrrrrrrraaaayyyyssss ....  There was not enough space for the
  102.      arrays that hold strip offsets and byte counts.
  103.  
  104. BBBBUUUUGGGGSSSS
  105.      Writing subsampled YCbCR data does not work correctly because, for
  106.      _P_l_a_n_a_r_C_o_n_f_i_g_u_r_a_t_i_o_n=2 the size of a scanline is not calculated on a per-
  107.      sample basis, and for _P_l_a_n_a_r_C_o_n_f_i_g_u_r_a_t_i_o_n=1 the library does not pack the
  108.      block-interleaved samples.
  109.  
  110. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  111.      _l_i_b_t_i_f_f(3T), _T_I_F_F_O_p_e_n(3T), _T_I_F_F_W_r_i_t_e_E_n_c_o_d_e_d_S_t_r_i_p(3T),
  112.      _T_I_F_F_W_r_i_t_e_R_a_w_S_t_r_i_p(3T)
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.